IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/cat3/libblas/syr.z/syr

Text File | 1998-10-30 | 13.5 KB | 265 lines

____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))                                                    ____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))



NNNNAAAAMMMMEEEE
     dsyr, ssyr, zher, cher - BLAS Level Two   (Symmetric/Hermitian)Matrix
     Rank 1 Update


FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ddddssssyyyyrrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           cccchhhhaaaarrrraaaacccctttteeeerrrr****1111        uuuupppplllloooo
           iiiinnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa
           ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn   aaaallllpppphhhhaaaa
           ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn   aaaa(((( llllddddaaaa,,,,****)))),,,, xxxx((((****))))

     ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssssssyyyyrrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           cccchhhhaaaarrrraaaacccctttteeeerrrr****1111        uuuupppplllloooo
           iiiinnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa
           rrrreeeeaaaallll               aaaallllpppphhhhaaaa
           rrrreeeeaaaallll               aaaa(((( llllddddaaaa,,,,****)))),,,, xxxx((((****))))

     ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee zzzzhhhheeeerrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           cccchhhhaaaarrrraaaacccctttteeeerrrr****1111        uuuupppplllloooo
           iiiinnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa
           ccccoooommmmpppplllleeeexxxx****11116666         aaaallllpppphhhhaaaa
           ccccoooommmmpppplllleeeexxxx****11116666         aaaa(((( llllddddaaaa,,,,****)))),,,, xxxx((((****))))

     ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee cccchhhheeeerrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           cccchhhhaaaarrrraaaacccctttteeeerrrr****1111        uuuupppplllloooo
           iiiinnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa
           ccccoooommmmpppplllleeeexxxx            aaaallllpppphhhhaaaa
           ccccoooommmmpppplllleeeexxxx            aaaa(((( llllddddaaaa,,,,****)))),,,, xxxx((((****))))



CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     vvvvooooiiiidddd ddddssssyyyyrrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           MMMMaaaattttrrrriiiixxxxTTTTrrrriiiiaaaannnngggglllleeee     uuuupppplllloooo;;;;
           IIIInnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa;;;;
           ddddoooouuuubbbblllleeee             aaaallllpppphhhhaaaa;;;;
           ddddoooouuuubbbblllleeee             ((((****aaaa))))[[[[llllddddaaaa****nnnn]]]],,,, ((((****xxxx))))[[[[ nnnn ]]]];;;;

     vvvvooooiiiidddd ssssssssyyyyrrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           MMMMaaaattttrrrriiiixxxxTTTTrrrriiiiaaaannnngggglllleeee     uuuupppplllloooo;;;;
           IIIInnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa;;;;
           ffffllllooooaaaatttt              aaaallllpppphhhhaaaa;;;;
           ffffllllooooaaaatttt              ((((****aaaa))))[[[[llllddddaaaa****nnnn]]]],,,, ((((****xxxx))))[[[[ nnnn ]]]];;;;

     vvvvooooiiiidddd zzzzhhhheeeerrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))
           MMMMaaaattttrrrriiiixxxxTTTTrrrriiiiaaaannnngggglllleeee     uuuupppplllloooo;;;;
           IIIInnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa;;;;
           ZZZZoooommmmpppplllleeeexxxx            aaaallllpppphhhhaaaa;;;;
           ZZZZoooommmmpppplllleeeexxxx            ((((****aaaa))))[[[[llllddddaaaa****nnnn]]]],,,, ((((****xxxx))))[[[[ nnnn ]]]];;;;

     vvvvooooiiiidddd cccchhhheeeerrrr(((( uuuupppplllloooo,,,, nnnn,,,, aaaallllpppphhhhaaaa,,,, xxxx,,,, iiiinnnnccccxxxx,,,, aaaa,,,, llllddddaaaa ))))



                                                                        PPPPaaaaggggeeee 1111






____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))                                                    ____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))



           MMMMaaaattttrrrriiiixxxxTTTTrrrriiiiaaaannnngggglllleeee     uuuupppplllloooo;;;;
           IIIInnnntttteeeeggggeeeerrrr            nnnn,,,, iiiinnnnccccxxxx,,,, llllddddaaaa;;;;
           CCCCoooommmmpppplllleeeexxxx            aaaallllpppphhhhaaaa;;;;
           CCCCoooommmmpppplllleeeexxxx            ((((****aaaa))))[[[[llllddddaaaa****nnnn]]]],,,, ((((****xxxx))))[[[[ nnnn ]]]]



DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     ddddssssyyyyrrrr and ssssssssyyyyrrrr perform the symmetric rank 1 operation

           A := alpha*x*x' + A,

     zzzzhhhheeeerrrr and cccchhhheeeerrrr perform the hermitian rank 1 operation

           A := alpha*x*conjg( x' ) + A,

     where alpha is a real/complex scalar, x is an n element vector and A is
     an n by n symmetric/hermitian matrix.


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     uuuupppplllloooo    On entry, uuuupppplllloooo specifies whether the upper or lower triangular
             part of the array A is to be referenced a follows:



             FFFFOOOORRRRTTTTRRRRAAAANNNN
             uplo = 'U' or 'u'   Only the upper triangular part of A
                                 is to be referenced.
             uplo = 'L' or 'l'   Only the lower triangular part of A
                                 is to be referenced.

             CCCC
             uplo = UpperTriangle     Only the lower triangular part of A
                                      is to be referenced.
             uplo = LowerTriangle     Only the lower triangular part of A
                                      is to be referenced.

             Unchanged on exit.

     nnnn       On entry, nnnn specifies the the order of the matrix A.  nnnn must be
             at least zero.
             Unchanged on exit.

     aaaallllpppphhhhaaaa   specifies the scalar alpha.
             Unchanged on exit.

     xxxx       Array of size at least ( 1 + ( n - 1 )*abs( incx ) ). Before
             entry, the incremented array xxxx must contain the n element vector
             x.
             Unchanged on exit.




                                                                        PPPPaaaaggggeeee 2222






____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))                                                    ____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))



     iiiinnnnccccxxxx    On entry, iiiinnnnccccxxxx specifies the increment for the elements of xxxx.
             iiiinnnnccccxxxx must not be zero.
             Unchanged on exit.

     aaaa       An array containing the matrix A.

             FFFFOOOORRRRTTTTRRRRAAAANNNN
             Array of dimension ( lda, n ).

             CCCC
             A pointer to an array of size lda*n.
             See note below about array storage convention for C.

             Before entry with uuuupppplllloooo ==== ''''UUUU'''' oooorrrr ''''uuuu'''' oooorrrr , the array elements
             corresponding to the leading n by n upper triangular part of the
             matrix A must contain the uppertriangular part of the
             symmetric/hermitian matrix and the corresponding strictly lower
             triangular part of A is not referenced. On exit, the array
             elements corresponding to the upper triangular part of the matrix
             A is overwritten by the upper triangular part of the updated
             matrix.

             Before entry with uuuupppplllloooo ==== ''''LLLL'''' oooorrrr ''''llll'''' oooorrrr , the array elements
             corresponding to the leading n by n lower triangular part of the
             matrix A must contain the lower triangular part of the
             symmetric/hermitian matrix and the corresponding strictly upper
             triangular part of A is not referenced. On exit, the array
             elements corresponding to the lower triangular part of the matrix
             A is overwritten by the lower triangular part of the updated
             matrix.

             Note that the imaginary parts of the diagonal elements need not
             be set and are assumed to be zero.

     llllddddaaaa     On entry, llllddddaaaa specifies the first dimension of A as declared in
             the calling (sub) program. llllddddaaaa must be at least ( k + 1 ).
             Unchanged on exit.


CCCC AAAARRRRRRRRAAAAYYYY SSSSTTTTOOOORRRRAAAAGGGGEEEE CCCCOOOONNNNVVVVEEEENNNNTTTTIIIIOOOONNNN
       The matrices  are assumed  to be stored in a  oooonnnneeee ddddiiiimmmmeeeennnnssssiiiioooonnnnaaaallll CCCC aaaarrrrrrrraaaayyyy
       in an analogous fashion as a Fortran array (column major). Therefore,
       the element  A(i+1,j)  of matrix A  is stored  immediately  after the
       element  A(i,j), while  A(i,j+1) is lda  elements apart from  A(i,j).
       The element A(i,j) of the matrix can be accessed directly by reference
       to  a[ (j-1)*lda + (i-1) ].


AAAAUUUUTTTTHHHHOOOORRRRSSSS
          Jack Dongarra, Argonne National Laboratory.
          Iain Duff, AERE Harwell.
          Jeremy Du Croz, Numerical Algorithms Group Ltd.



                                                                        PPPPaaaaggggeeee 3333






____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))                                                    ____SSSSYYYYRRRR,,,,____HHHHEEEERRRR((((3333FFFF))))



          Sven Hammarling, Numerical Algorithms Group Ltd.






















































                                                                        PPPPaaaaggggeeee 4444